<HTML>
<BODY>

<a href="..\readme.html">back</a>
<H2><center>tddConsole</center></H2>
<HR />
<img src="http://toolbox/23791/Project/FileDownload.aspx?DownloadId=12579" alt="console.output.jpg" />
<HR />
<PRE>
tddConsole.exe usage:
        tddConsole dirname, or
        tddConsole dllname <test specifications>

        dirname - search directories recursively for and run test dlls,
                  starting in dirname
        dllname - run the tests in dllname,
                  subject to < test specifications > options

        < test specifications >:

        namespace1::class1 < namespace2::class2, ... > - run all tests in the namespace1::class1,
                                                         then namespace2::class2, etc.
        namespace1::class1.specifictest1 < namespace2::class2.specifictest2, ... > - run specifictest1 from namespace1::class1,
                                                         then specifictest2 from namespace2::class2, etc.
        tddConsole dllname -? or /? - dump all test names in specified dll.
</PRE>

<HR />
<PRE>
To dump all the test names in a particular dll (from the current directory, where this readme.txt resides):

	objc\i386\tddConsole.exe unittests\objc\i386\TddConsoleUnitTests.dll -?
results in:
	Slow::FindFileTests.FindCurrentTestDllAsFile
	Slow::FindFileTests.FailToFindAnotherDll
		... <b style="color:green;background-color:#ffffff">// some entries removed for clarity</b>
	SomeNamespaceUsedForGroupingTests::AnotherDeeperNamespace::ExampleClassTests.TestZero
	SomeNamespaceUsedForGroupingTests::AnotherDeeperNamespace::ExampleClassTests.TestOne
</PRE>
<HR />
<PRE>
To run just one test:
	objc\i386\tddConsole.exe unittests\objc\i386\TddConsoleUnitTests.dll SomeNamespaceUsedForGroupingTests::AnotherDeeperNamespace::ExampleClassTests.KnownBigPrime
This results in the following output:  <b style="color:green;background-color:#ffffff">"0 failures out of 1 test run"</b>
</PRE>
<HR />
<PRE>
To run a group of tests, by namespace or test class name:
	objc\i386\tddConsole.exe unittests\objc\i386\TddConsoleUnitTests.dll SomeNamespaceUsedForGroupingTests
or
	objc\i386\tddConsole.exe unittests\objc\i386\TddConsoleUnitTests.dll SomeNamespaceUsedForGroupingTests::AnotherDeeperNamespace::ExampleClassTests
results in:
        <b style="color:green;background-color:#ffffff">"0 failures out of 22 tests run"</b>.
</PRE>
<HR />
<PRE>
To run all the tests in a dll,
	objc\i386\tddConsole.exe unittests\objc\i386\TddConsoleUnitTests.dll
results in:
	Failure in Slow::TestRunnerTests.AlwaysFail -
	e:\dd\dtg03_1\src\setup\vssetup\utils\tdd\tddconsole\unittests\testrunnertests.cpp(23) : ERROR : "a temporary test that always fails"
	<b style="color:red;background-color:#ffffff">1 failure out of 63 tests run</b>
with 1 expected failure.
</PRE>
<HR />
<PRE>
To run all the tests in all test dlls recursively starting with a particular directory,
	objc\i386\tddConsole.exe ..
results in:
	Failure in TDD_Tests::TddAssertTests.BSTRsWithEmbeddedNullsWillSucceedWhenTheyShouldFail -
	e:\dd\dtg03_1\src\setup\vssetup\utils\tdd\tddassert\tddasserttests.cpp(184) : ERROR : "Comparing BSTRs with embedded NULLs via CStrings doesn't work!"
	Failure in Slow::TestRunnerTests.AlwaysFail -
	e:\dd\dtg03_1\src\setup\vssetup\utils\tdd\tddconsole\unittests\testrunnertests.cpp(23) : ERROR : "a temporary test that always fails"
	<b style="color:red;background-color:#ffffff">2 failures out of 86 tests run</b>
with 2 expected failures.
</PRE>

<HR />
<P>To build, open either the solution or the tddConsole.vcproj file in VS2008.</P>

</BODY>
</HTML>